home *** CD-ROM | disk | FTP | other *** search
/ Usenet 1993 July / InfoMagic USENET CD-ROM July 1993.ISO / answers / inn-faq / part3 < prev    next >
Encoding:
Internet Message Format  |  1993-06-04  |  7.5 KB

  1. Path: senator-bedfellow.mit.edu!enterpoop.mit.edu!gatech!darwin.sura.net!spool.mu.edu!olivea!uunet!news.mentorg.com!sdl!not-for-mail
  2. From: tal@Warren.MENTORG.COM (Tom Limoncelli)
  3. Newsgroups: news.software.nntp,news.software.b,news.answers
  4. Subject: FAQ: Norman's INN quick-start guide (Part 3 of 3)
  5. Supersedes: <inn-faq-3-737870420@Warren.MENTORG.COM>
  6. Followup-To: news.software.nntp
  7. Date: 5 Jun 1993 04:00:28 -0000
  8. Organization: Mentor Graphics - IC Group, Warren, NJ, USA
  9. Lines: 174
  10. Approved: news-answers-request@MIT.Edu
  11. Distribution: world
  12. Expires: 06/20/93
  13. Message-ID: <inn-faq-3-739252815@Warren.MENTORG.COM>
  14. References: <inn-faq-1-739252815@Warren.MENTORG.COM>
  15. Reply-To: Tom_Limoncelli@Warren.MENTORG.COM (Tom Limoncelli)
  16. NNTP-Posting-Host: sdl.warren.mentorg.com
  17. Summary: Part 1: Common questions about INN itself, and some advice when compiling it and installing it.  Part 2: This assumes that you've successfully compiled the software.  This is a tutorial that takes you through configuration and setting up feeds.  It ends with common questions about INN configuration.  Part 3: Norman's quick guide to getting started (assumes SunOS) and other things)
  18. Xref: senator-bedfellow.mit.edu news.software.nntp:4668 news.software.b:14268 news.answers:9077
  19.  
  20. Posted-By: auto-faq 2.4
  21. Archive-name: inn-faq/part3
  22.  
  23.  
  24. Last Changed: $Id: FAQ-inn.3,v 1.6 1993/04/13 19:21:00 tal Exp tal $
  25.  
  26. This is a separate guide to installing INN.  It is written for INN 1.4,
  27. but should work on INN 1.4.  It is written and maintained by Norman J.
  28. Pieniazek (norman@giardia.pdb.cdc.gov).  Please send updates and
  29. corrections to him.
  30.  
  31.  
  32.  
  33. INSTALLATION AND MAINTENANCE OF INN 1.4
  34.  
  35.  
  36. I. INSTALLATION
  37.  
  38.  
  39.  
  40. 1. Get: inn1.4.tar.Z from ftp.uu.net (192.48.96.9).  This file is in
  41.    the directory: /networking/news/nntp/inn
  42.  
  43. 2. Get: patch.tar.Z from ftp.uu.net.  This file is in the directory /pub.
  44.    Compile and install patch in the directory: /usr/local/bin.
  45.  
  46. 3. If you have a Sun SPARCstation running SunOS 4.1.x and no gnu
  47.    software, ftp to aeneas.mit.edu (18.71.0.38), go to directory
  48.    /pub/gnu and get the following files.
  49.  
  50.    fgrep        current version: fgrep-1.1
  51.    gawk            current version: gawk-2.15.2
  52.    gcc            current version: gcc-2.4.2
  53.    grep            current version: grep-1.6
  54.    make            current version: make-3.65
  55.    sed            current version: sed-1.14
  56.  
  57.    Compile and install these programs starting with make and gcc.
  58.  
  59. 4. Get perl-4.0.36.tar.Z from ftp.uu.net - directory: /archive/systems/gnu.
  60.    Compile and install in /usr/bin.
  61.  
  62. 5. As root, create directories:    /usr/local/inn (this is your $INN directory)
  63.                 /usr/local/news
  64.                 /news/bin
  65.                 /news/lib
  66.  
  67. 6. Move inn1.4.tar.Z to $INN.  Change directory to $INN  
  68.    Type: "zcat inn1.4.tar.Z | tar xvf -".  This will install
  69.    inn files for compilation.
  70.  
  71. 7. Change directory to $INN/config and follow the instructions
  72.    in R. Salz's INN nstallation manual.  At least, change
  73.    the compiler from cc to gcc. (If you have Solaris 2.1 - see changes
  74.    made to the config files in Daniel Rich's letter).
  75.  
  76. 8. Change directory to $INN.  Type: "make world install".
  77.  
  78. 9. If you get no fatal errors from make, check the /usr/local/news
  79.    directory for history* files.  Remove or rename them.  Go back
  80.    to the $INN directory and type: "BUILD" to run the final
  81.    installation script.
  82.  
  83. 10. Get: /networking/news/nntp/inn/tutorial.Z from ftp.uu.net
  84.     Follow instructions to set up at least your newsfeeds, hosts.nntp,
  85.     and nnrp.access files.  Get the active file from your newsfeed and
  86.     edit it to your taste. Remember to include the control and junk
  87.     newsgroups.
  88.  
  89. 11. Type: "/usr/bin/perl /usr/local/news/bin/inncheck" and correct
  90.     any errors reported by inncheck.
  91.  
  92. 12. Type: "sh /usr/local/etc/rc.news".  Look in syslog
  93.     for any errors.  Type: "ps -aux" and check, if innd owner
  94.     is news.
  95.  
  96. 13. In /etc/aliases create an entry: "usenet: <you, or root>". 
  97.     Reboot, change directory to /var/yp, type: "make".  From the same
  98.     directory, type: "/usr/etc/yp/ypinit -m".  Restart innd (see #12).
  99.  
  100. 14. Type: "/bin/crontab -e news" and insert the following line:
  101.     40 23 * * * /usr/local/news/bin/news.daily delayrm
  102.  
  103. 15. Run tests from your machine to the server (your machine at telnet
  104.     port 119).  See Tom Limoncelli's manual for details.
  105.  
  106. 16. After completing the test, be sure to delete the entry for your
  107.     machine from the hosts.nntp file.  If you will not do it, your
  108.     machine will be treated as a "feeder" and not as a "reader".
  109.  
  110. 17. Watch the news.daily reports in your mail for any
  111.     additional errors.
  112.  
  113. 18. Adding new groups - see Part II, Section 2.b, or:
  114.     a. Type: "ctlinnd pause 'edit active'"
  115.     b. Edit the active file.  Format is: groupname himark lomark flag.
  116.        Set himark to 0000000000 and lomark to 0000000001.
  117.     c. Run inncheck (see #11) to check the new active file for errors.    
  118.     d. Type: "ctlinnd reload active 'new active'".
  119.     e. Type: "ctlinnd go 'edit active'".
  120.  
  121. 19. Set posting. 
  122.      a. Edit the /usr/local/news/newsfeeds file and add:
  123.     <alias for your feed>/<full address of feed\
  124.         :*\    (for all local postings)
  125.         :Tf,Wnm:    (standard entry)
  126.      b. Edit /usr/local/news/nntpsend.ctl file and add:
  127.         <alias for your feed>:<full address of feed>::-T1800 -t300
  128.      c. Type: "/bin/crontab -e news" and insert a line:
  129.     0,10,20,30,40,50 * * * * /usr/local/news/bin/nntpsend
  130.      d. Run inncheck (see #11).
  131.      e. Post to misc.test and include reply in the Subject line,
  132.         automatic responses will be mailed to usenet (see 13) within
  133.         a few minutes.
  134.  
  135. 20. To start innd automatically at bootup, include at the end of
  136.     your rc.local the following lines:
  137.  
  138.     #
  139.     # Start INN news service - Internet News Daemon (innd)
  140.     #
  141.     if [ -f /usr/local/etc/rc.news ]; then
  142.            /usr/local/etc/rc.news; echo "Starting INN news service"
  143.     fi
  144.  
  145.   
  146.  
  147. II. MAINTENANCE
  148.  
  149. 1. Newgroups are sometimes added automatically through a control message.
  150.    A mail message to usenet will alert to such an automatic change
  151.    to the active file.  If you do not want to subscribe to a news group,
  152.    change directory to /usr/local/news and type:
  153.    
  154.     ctlinnd rmgroup xx.xxx.xx
  155.  
  156. 2. Sometimes, a mail message will arrive for usenet with a checkgroups
  157.    file.  Remove header, save the body of the message in:
  158.    
  159.    /usr/local/news/bin/control/news_control/news_control_todaysdate
  160.    
  161.    cd to that directory and type:
  162.    "../docheckgroups <news_control_todaysdate >todaysdate_pre"
  163.    
  164.    Read the output file (todaysdate_pre) and carry out all the instructions
  165.    that you think pertain to your situation.  You will have to change
  166.    directory to /usr/local/news and:
  167.     
  168.     a. remove some discontinued groups:
  169.         type: "ctlinnd rmgroup xx.xxx.xxxx"
  170.  
  171.     b. add a group:
  172.         type: "ctlinnd newgroup xx.xxx.xxxx flag ''"
  173.  
  174.     c. mark a group correctly:
  175.         type: "ctlinnd changegroup xx.xxx.xxxx flag"
  176.  
  177.   Run inncheck and repeat the docheckgroups command:
  178.    "../docheckgroups <news_control_todaysdate >todaysdate_after"
  179.    Check for any problems.  
  180.  
  181.    Also, edit the /usr/local/news/newsgroups file to reflect any
  182.    changes you introduced.
  183.  
  184. 3. IMPORTANT!!! Never run fsck on the drive where the /spool/news
  185.    files are located.  Innd has a lot of active disk I/O going on
  186.    and fsck will show a lot of errors.  Use ctlinnd to throttle,
  187.    pause, or shotdown innd - see the manual page for ctlinnd.
  188.  
  189. -- 
  190. Tom Limoncelli -- tal@warren.mentorg.com (work) -- tal@plts.org (play)
  191. "People are not pigs, they'll eat anything!"   -ambiguous Slavic saying
  192. Disclaimer:  I do not speak for Mentor Graphics.
  193.              I can't even do the accent.
  194.